home *** CD-ROM | disk | FTP | other *** search
/ Experimental BBS Explossion 3 / Experimental BBS Explossion III.iso / compress / pkpres32.zip / PKPRESS.DOC < prev    next >
Text File  |  1993-11-11  |  11KB  |  279 lines
  1. Pkpress 3.2, Copyright 1993 by Maritime Computer and Michael W. Graham
  2.  
  3.  
  4.                         Introduction:
  5.  
  6. Pkpress is a command line utility that will increase your hard drive 
  7. space.  You tell Pkpress which directories to process, and it will
  8. find all zip files, recompress them (if necessary) with PKZIP's
  9. maximal compression.  It will also process the comment (if any)
  10. on the zip file.  The recompression to maximal can save MEGABYTES of
  11. HD space if you have a lot of zip files.  It can also be run as an
  12. event, upload processor, or from a batch file.
  13.  
  14. This program will work equally well with PKZIP 1.1 or 2.04g. However,
  15. if you are using version 2.04g, you will have the added benefit of
  16. converting any 1.1 files to 2.04, which will SAVE even more DISK SPACE.
  17.  
  18.  
  19.                        Quick Setup :
  20.  
  21. Guess what?  Absolutely NOTHING has to be in your path!  Just make sure 
  22. that PKPRESS and it's associated configuration file are in the same
  23. directory.  Please erase ALL older versions of Pkpress on your system!
  24.  
  25.         I.  Put PKPRESS.EXE and PKPRESS.CNF in the same directory.
  26.  
  27.        II.  Edit the Config file (PKPRESS.CNF) for your specifications.
  28.  
  29.             Each Line must contain [THIS|THAT|<somethingelse>]
  30.                                         ^----^----OR        ^--Brackets
  31.                                                                mean replace
  32.                                                                with info
  33.                 1: [0|<registration code>]                                      
  34.                 2: [ALL|NOTMAX]
  35.                 3: [YES|NO]
  36.                 4: [NONE|DEFAULT|<location & name of comment file>]
  37.                 5: [REPLACE|APPEND|SAVE|STRIP]
  38.                 6: [<location & name of pkzip>]
  39.                 7: [<location & name of pkunzip>]
  40.                 8: [YES|NO]
  41.                 9: [YES|NO]
  42.  
  43.             Here is the meaning of each line in the config file:
  44.  
  45.               1:  Registration code - if unregistered, leave as 0
  46.               
  47.               2:  You can either process ALL files or only files that
  48.                   do not already have maximum compression. (You may
  49.                   want to do ALL files in order to process the 
  50.                   comments, etc.)  Otherwise, it is much faster to
  51.                   skip files that already have max compression. 
  52.                   Line 2 is either ALL or NOTMAX.
  53.  
  54.               3:  If you use a 3rd party memory manager (like QEMM),
  55.                   put YES, if not put NO.
  56.  
  57.              *4:  Comment File:  Put the drive:\path\name of a comment
  58.                   file you would like to add.  This file is any text
  59.                   file that you would like to appear as a comment.
  60.                   If you use your own comment file, put it like so:
  61.                   C:\TEMP\MYCMT.TXT  (or any path\file you like).
  62.                   Alternatively, you can use the DEFAULT comment file,
  63.                   or choose NONE.
  64.                   (Unregistered version must be set to DEFAULT)
  65.  
  66.              *5:  Comment Mode:  Do you want to REPLACE the existing 
  67.                   comment with a new one, APPEND the new one to the
  68.                   end of the existing one, SAVE the existing comment
  69.                   unchanged, or STRIP all comments from the zip file.
  70.                   (Unregistered version must be set to APPEND)
  71.  
  72.               6:  Drive:\Path\Name   Location of PKZIP
  73.                   (Ex:  E:\ZIP\PKZIP.EXE)
  74.  
  75.               7:  Drive:\Path\Name   Location of PKUNZIP
  76.  
  77.               8:  Do you want to record a Logfile (YES or NO)
  78.                   The logfile will be created as a text file in the
  79.                   directory that pkpress.exe is located as LOGFILE.TXT
  80.  
  81.              *9:  If the zip file has a FILE_ID.DIZ description file,
  82.                   do you want to insert that description into the
  83.                   comment?  (YES or NO)
  84.                   (Unregistered version must be set to NO)
  85.  
  86.               * - can only alter with registered version
  87.               
  88.               Please see the sample PKPRESS.CNF file to see how it looks.
  89.  
  90.  
  91.         III.  Now you are ready to process (for one directory)
  92.                 
  93.                 1. Switch to the directory that pkpress is in.
  94.  
  95.                 2.  Type PKPRESS and the drive & directory you wish to
  96.                     process.
  97.  
  98.                 
  99.  
  100.              ---------------------------------------------------------------
  101.                         
  102.                         To process all zip files in C:\TEMP, type:
  103.  
  104.                         
  105.                         pkpress c:\temp      
  106.  
  107.  
  108.              ---------------------------------------------------------------
  109.                 
  110.         IV.  If you would like to process multiple directories:
  111.  
  112.                 edit the file named DIRECT.LST
  113.                         
  114.                 the first line will be the drive you wish to process:
  115.  
  116.                 C:
  117.  
  118.                 the remaining lines are any directories you want processed:
  119.  
  120.                 \TEMP
  121.                 \TEMP\TEST
  122.                 \ZIPS
  123.                 \OLDZIPS
  124.                 \DOS\ARCS\OLD
  125.                 \KEEP
  126.  
  127.                 You may put as many directories as you like in this file,
  128.                 one on each line, and preceded by a "\"  (without quotes)
  129.  
  130.  
  131.                 This file DIRECT.LST must be in the same directory
  132.                 as PKPRESS.EXE and PKPRESS.CNF.
  133.  
  134.       ----------------------------------------------------------------
  135.  
  136.                 Now, to process all zip files in the directories
  137.                 in the Direct.Lst file, type:
  138.  
  139.                 
  140.                 pkpress direct.lst
  141.  
  142.         -------------------------------------------------------------
  143.                 Please see the sample DIRECT.LST file.
  144.  
  145.  
  146.  
  147.  
  148.         
  149.                         Some Recommendations:
  150.  
  151.         
  152.         Test Pkpress on a sample directory before processing
  153.         a full directory to ensure system compatibility.
  154.         
  155.         
  156.         Use common sense when setting comment processing features
  157.         in the config file  (just to save time):
  158.  
  159.         For example:
  160.  
  161.                 If STRIPping comments, use comment file type NONE
  162.  
  163.                 If SAVEing comments, use comment file type NONE
  164.  
  165.                 If comment file type is NONE, don't set the mode
  166.                 to APPEND, just use SAVE.
  167.  
  168.                 If comment file type is NONE, don't set the mode
  169.                 to REPLACE, just put STRIP.
  170.  
  171.  
  172.                 Since existing comments may already have the File
  173.                 Id description in them, I suggest only setting the
  174.                 insert file_id diz description in commment to YES
  175.                 if you are REPLACEing comments.
  176.  
  177.  
  178.         
  179.         The more comments you add to each zip file, the LESS space 
  180.         you will save.  
  181.  
  182.         FOR MAXIMUM SPACE AND SPEED set comment file to NONE and
  183.         comment mode to STRIP.
  184.  
  185.         If you choose to use pkzip 1.1 and pkpress comes across a
  186.         2.04 file, it cannot process it.  A message about "too high
  187.         a version" will be on the status line and in the log file.
  188.  
  189.  
  190.                         TroubleShooting:
  191.  
  192.  
  193.         Only use pkpress on Fixed Local drives; that is don't use on
  194.         floppy drives or network drives.
  195.  
  196.         Press <ESC> at anytime to abort processing.
  197.  
  198.         If you have a registered version of pkzip, it is possible that
  199.         the pkzip configuration file is confusing pkpress.  Temporarily
  200.         remove the pkzip config file.  Pkpress should not have a problem
  201.         but it could be possible.
  202.  
  203.   ***   For general errors or any other weird problems, try setting
  204.         line 2 (using a 3rd party memory manager) to YES, even if you
  205.         are not.
  206.  
  207.         If you have a message about CRC errors, try running Pkpress
  208.         from the directory it resides in (not from a path statement,
  209.         or from another directory as c:\pkp\pkpress.exe) first switch
  210.         to that directory.  If you continue to get this message, the
  211.         code you have may have been tampered with - call the Guild
  212.         BBS for a clean copy.
  213.  
  214.  
  215.                         Files you should have:
  216.  
  217.  
  218.                 PKPRESS.EXE             The program executable
  219.                 PKPRESS.DOC             This file
  220.                 PKPRESS.CNF             Configuration file
  221.                 DIRECT.LST              Multi-directory control file
  222.                 LOGFILE.TXT             Sample Log File
  223.                 FILE_ID.DIZ             Description file
  224.                 ORDER.FRM               Order form for registration
  225.  
  226. Credits:
  227.  
  228.         PKZIP is (c) 1993 by PKWARE, Inc.
  229.         Routines from Tom Hanlin's PBCLONE were used.
  230.         PBCLONE is (c) 1993 by Tom Hanlin
  231.         PKPRESS is (c) 1993 by Maritime Computer
  232.  
  233.  
  234.  
  235.  
  236.  This program is fully functional.  If you use it, please register it. 
  237.  
  238.  Registration is ONLY  $15.00 (US) - help support shareware authors!
  239.  
  240.  Registration will also give you extended access to our support BBS, and
  241.  free upgrades of newer versions - and there will be newer versions with
  242.  more functions.   
  243.                         
  244.                         
  245.                         The Glazer's Guild BBS
  246.                            (804) 739-9315
  247.  
  248.                         Maritime Computer Services
  249.                              PO Box 1846
  250.                           Midlothian, VA 23113
  251.  
  252.  
  253.  To register, please send check or money order to the above address. You
  254.  will receive access to the Guild, and free updates for new versions.
  255.  Please include the program name, version number, along with your pertinent
  256.  information : (name, address, phone, etc.).  Please use the order form,
  257.  ORDER.FRM for faster processing on your registration.
  258.  
  259.  ** Registration will remove the pkpress "ad" appended to comments in each
  260.  ** zip file and the processed zip file will have the file date of the most  
  261.  ** recent internal file.  Unregistered versions use today's date on all
  262.  ** processed files.   You will also receive support via our BBS. In addition,
  263.  ** registration will enable full use of the pkpress config file, allowing
  264.  ** you to fully process comments and other valuable features you can "unlock"
  265.  
  266.  
  267.  DISCLAIMER:
  268.  
  269.  We ("Maritime Computer" or "Michael W. Graham") are not responsible 
  270.  for any damages of any kind, including profit losses and data losses, 
  271.  that relate directly or indirectly to these programs and files.  
  272.  You may distribute this program, as long as it is in unmodified form 
  273.  with all the files originally included.  Do not "reverse engineer" or 
  274.  unassemble this program.
  275.  
  276.  This program and associated files may not be distributed for a fee
  277.  without express written consent from the author.
  278.  
  279.